home *** CD-ROM | disk | FTP | other *** search
/ Network Supervisor's Toolkit / Network Supervisor's Toolkit.iso / tools / lu62 / read.me < prev    next >
Text File  |  1996-07-10  |  6KB  |  142 lines
  1. 1. Program description and audience
  2. =====================================
  3.  
  4. This is an implementation for MS-DOS of the IBM's SNA LU 6.2 protocol.
  5.  
  6. This package is intended for those who want to make your own 
  7. implementation of the IBM SNA LU 6.2 protocol, so you can treat it and as 
  8. a "LU 6.2 development kit".
  9.  
  10. If you have not intention to make something for communication with IBM SNA
  11. LU 6.2 on your own or make some kind of a distributing processing system, 
  12. I'm afraid these programs will be useless for you.
  13.  
  14. The package contains executable files, source files, a "make" file for
  15. building the LU 6.2 module itself, a "make" file for building the sample
  16. application and "make" files for building the intermediate drivers for
  17. working with COM# and Novell IPX.
  18.  
  19. All programs are well debugged, the LU 6.2 module itself worked in a real
  20. SNA network. (As a matter of fact I wrote two versions of LU 6.2, one for
  21. MS-DOS and another for Unix System V. Both of them worked in the one SNA
  22. network and communicated each other.)
  23.  
  24. The LU 6.2 module isn't a complete network product, it needs for a work at
  25. first an application program and on the other hand a driver (program,
  26. module) which can support the network and session layers.
  27.  
  28. 2. What is the LU 6.2 ?
  29. ========================
  30.  
  31. LU 6.2 is a name for a high level communication protocol which was
  32. designed by IBM to support peer to peer communications.
  33.  
  34. The LU type 6.2 was the first type of IBM SNA LU which can communicate
  35. directly with another one of the same type. The LU 6.2 was especially
  36. designed to support inter-program communications; an another name of this
  37. protocol is "Advanced Program to Program Communication" (APPC).
  38.  
  39. (If you do not familiar with LU 6.2 IBM SNA terminology, please refer to
  40. "System Network Architecture. Format and Protocol Reference Manual:
  41. Architecture Logic for LU Type 6.2" and to "System Network Architecture.
  42. Transaction Programmer's Reference Manual For LU Type 6.2".)
  43.  
  44. As it was defined in "Transaction Programmer's Reference Manual For LU
  45. Type 6.2" the LU 6.2 meets the following requirements:
  46. - simultaneous activation;
  47. - efficient allocation;
  48. - conversation overhead;
  49. - conversation lifetime;
  50. - two way alternate data transfer;
  51. - attention mechanism;
  52. - error notification;
  53. - commitment control;
  54. - symmetry;
  55. - mode of service;
  56. - levels of conversation;
  57. - subset definition.
  58.  
  59. 3. About my implementation of the LU 6.2 protocol
  60. ==================================================
  61.  
  62. This program is free software; you can redistribute it and/or modify it
  63. under the terms of the GNU General Public License as published by the Free
  64. Software Foundation, version 1.
  65.  
  66. This program is distributed in the hope that it will be useful, but
  67. WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
  68. or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  69. for more details.
  70.  
  71. This implementation of the LU 6.2 was developed from scratch, using
  72. information from the previously mentioned books and from documentation on
  73. the IBM program product "APPC-PC".
  74.  
  75. The LU6.2 module uses the same program interface as IBM's APPC-PC has,
  76. moreover I've tried to make the program interface of LU 6.2 module as
  77. close to the APPC-PC program interface as it possible.
  78.  
  79. (So it's very useful to be familiar with APPC-PC documentation because if
  80. you understand the ideas of APPC-PC functionally it makes for you more
  81. clear the ideas of LU6.2 module functionally. Besides I do not provide
  82. here detailed descriptions of a program interface of the LU6.2 module. I
  83. have two reasons to do that:
  84. - you can use the "APPC-PC programmer's guide";
  85. - if you really need that description I can send it on your request.)
  86.  
  87. To make more easy developing of the "C" program I wrote a set of iterface
  88. programs, you can find them in the "PROC" dirctory.
  89.  
  90. 4. The main features of my implementation of the LU 6.2 protocol
  91. =================================================================
  92.  
  93. 4.1. The LU 6.2 module implements PS, RM and partly the LNS level; it does
  94. not implement the HS level, so there must be another program which can
  95. support that level and provide the way of communication between the LU 6.2
  96. module and a network adapter driver.
  97.  
  98. 4.2. The full enough compatibility with the APPC-PC at the object code
  99. level ( I mean here the compatibility only for that subset of verbs
  100. which my LU 6.2 module supports). The LU 6.2 module has the same API via
  101. int 68h as the APPC-PC has.
  102.  
  103. 4.3. In fact, my LU is combined LU, it can support the LU 6.2 protocol as
  104. well as the LU 0 protocol.
  105.  
  106. 5. Installation
  107. ================
  108. Make "/LU62" directory, place in it the "lu62.zip" file, type
  109. pkunzip -d lu62.zip
  110. in command line and press the "Enter" key.
  111.  
  112. 6. List of components
  113. ======================
  114.  
  115. This package includes source code for the LU 6.2 module (in directory
  116. /LU62, LU62/INCLUDE and LU62/PORT);
  117.  
  118. The source of sample application program (in the directory /LU62/DEBUG)
  119. read the file "read.me" it that directory for details, please.
  120.  
  121. The source code of the driver which acts as replacement of HS component and
  122. works with Novell IPX (in the directory /LU62/NOVELL).
  123.  
  124. The source code of the driver which acts as replacement of HS component and
  125. works with the asynchronous port (in the directory /LU62/COMM).
  126.  
  127. The source code of "C" application program interface modules and the API
  128. object modules library (in the directory /LU62/PROC).
  129.  
  130. 7. Program tools
  131. =================
  132.  
  133. All programs have been developed using the MicroSoft's "C" version 6.0 and
  134. MASM 6.1.
  135.  
  136. 8. How you can contact me
  137. ==========================
  138.  
  139. Email: poljakov@vertex.inria.msu.ru
  140.  
  141. If you have any comments or questions, feel you free to contact me, please.
  142.